feat: translate library/asyncio-graph.po by josix · Pull Request #1208 · python/python-docs-zh-tw

josix · 2026-02-04T12:37:47Z

Complete translation of asyncio Call Graph Introspection documentation covering print_call_graph(), format_call_graph(), capture_call_graph() and low-level utility functions.

github-actions · 2026-02-04T12:43:37Z

PR Preview Action v1.8.1
🚀 View preview at https://python.github.io/python-docs-zh-tw/pr-preview/pr-1208/
Built to branch `gh-pages` at 2026-02-04 12:48 UTC. Preview will be ready when the GitHub Pages deployment is complete.

josix · 2026-02-04T12:50:55Z

https://python.github.io/python-docs-zh-tw/pr-preview/pr-1208/library/asyncio-graph.html

mattwang44 · 2026-03-14T05:21:15Z

library/asyncio-graph.po

 #: ../../library/asyncio-graph.rst:8
 msgid "Call Graph Introspection"
-msgstr ""
+msgstr "呼叫圖內省（Graph Introspection）"


「自識」(ref)、「內省」(wiki) 我都可以接受

josix · 2026-03-14T05:30:47Z

thanks 那保留內省好了看起來是常見的翻法
btw 補上 context

@mattwang44 @ken71301 你們對 Introspection 的翻譯有什麼想法嗎～意義上接近有一套可以觀察內部狀態的機制，但內省有點不到位的感覺

mattwang44 · 2026-03-15T15:37:45Z

library/asyncio-graph.po

 #: ../../library/asyncio-graph.rst:8
 msgid "Call Graph Introspection"
-msgstr ""
+msgstr "呼叫圖內省（Graph Introspection）"


只少掉一字 call 怕誤導

Suggested change

msgstr "呼叫圖內省（Graph Introspection）"

msgstr "呼叫圖內省（Call Graph Introspection）"

Fixed in 55f3893: "呼叫圖內省（Call Graph Introspection）"

mattwang44 · 2026-03-15T15:38:04Z

library/asyncio-graph.po

 "within a Python program or by external profilers and debuggers."
 msgstr ""
+"asyncio 擁有強大的執行期呼叫圖內省工具，可以追蹤執行中的\\ *協程*\\ 或\\ "
+"*任務*\\ ，或是暫停的\\ *future*\\ 的完整呼叫圖。這些工具和底層機制可以在 "


Suggested change

"*任務*\\ ，或是暫停的\\ *future*\\ 的完整呼叫圖。這些工具和底層機制可以在 "

"*任務*，或是暫停的 *future* 的完整呼叫圖。這些工具和底層機制可以在 "

Fixed in 55f3893.

mattwang44 · 2026-03-15T15:38:23Z

library/asyncio-graph.po

 "*future*.  These utilities and the underlying machinery can be used from "
 "within a Python program or by external profilers and debuggers."
 msgstr ""
+"asyncio 擁有強大的執行期呼叫圖內省工具，可以追蹤執行中的\\ *協程*\\ 或\\ "


目前 runtime 都不翻

Suggested change

"asyncio 擁有強大的執行期呼叫圖內省工具，可以追蹤執行中的\\ *協程*\\ 或\\ "

"asyncio 擁有強大的 runtime 呼叫圖內省工具，可以追蹤執行中的\\ *協程*\\ 或\\ "

Fixed in 55f3893: kept "runtime" untranslated.

mattwang44 · 2026-03-15T15:40:12Z

library/asyncio-graph.po

 msgstr ""
+"asyncio 擁有強大的執行期呼叫圖內省工具，可以追蹤執行中的\\ *協程*\\ 或\\ "
+"*任務*\\ ，或是暫停的\\ *future*\\ 的完整呼叫圖。這些工具和底層機制可以在 "
+"Python 程式內部使用，或被外部分析器和除錯器使用。"


Suggested change

"Python 程式內部使用，或被外部分析器和除錯器使用。"

"Python 程式內部使用，或被外部分析器和偵錯器使用。"

Fixed in 55f3893: 偵錯器.

mattwang44 · 2026-03-15T15:41:37Z

library/asyncio-graph.po

 "*depth* argument can be used to skip the specified number of frames from top "
 "of the stack."
 msgstr ""
+"如果在\\ *當前任務*\\ 上呼叫此函式，可以使用選擇性的僅限關鍵字引數 *depth* "


https://github.com/python/python-docs-zh-tw/wiki/%E8%A1%93%E8%AA%9E%E5%88%97%E8%A1%A8#%E5%85%B6%E4%BB%96%E7%BF%BB%E8%AD%AF%E7%BF%92%E6%85%A3

使用「目前」而非「當前」

Suggested change

"如果在\\ *當前任務*\\ 上呼叫此函式，可以使用選擇性的僅限關鍵字引數 *depth* "

"如果在\\ *目前任務*\\ 上呼叫此函式，可以使用選擇性的僅限關鍵字引數 *depth* "

Fixed in 55f3893: changed to 目前任務.

mattwang44 · 2026-03-15T15:45:12Z

library/asyncio-graph.po

+"類似於 :func:`print_call_graph`\\ ，但回傳一個字串。如果 *future* 為 "
+"``None`` 且沒有當前任務，此函式回傳一個空字串。"


Suggested change

"類似於 :func:`print_call_graph`\\ ，但回傳一個字串。如果 *future* 為 "

"``None`` 且沒有當前任務，此函式回傳一個空字串。"

"類似於 :func:`print_call_graph`，但回傳一個字串。如果 *future* 為 "

"``None`` 且沒有目前任務，此函式回傳一個空字串。"

Fixed in 55f3893.

mattwang44 · 2026-03-15T15:45:34Z

library/asyncio-graph.po

 "Capture the async call graph for the current task or the "
 "provided :class:`Task` or :class:`Future`."
 msgstr ""
+"捕獲當前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"


Suggested change

"捕獲當前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"

"捕獲目前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"

Fixed in 55f3893.

mattwang44 · 2026-03-15T15:45:51Z

library/asyncio-graph.po

+"此函式接受一個選擇性的 *future* 引數。如果未傳入，將使用當前執行中的任務。"
+"如果沒有當前任務，此函式回傳 ``None``\\ 。"


Suggested change

"此函式接受一個選擇性的 *future* 引數。如果未傳入，將使用當前執行中的任務。"

"如果沒有當前任務，此函式回傳 ``None``\\ 。"

"此函式接受一個選擇性的 *future* 引數。如果未傳入，將使用目前執行中的任務。"

"如果沒有目前任務，此函式回傳 ``None``。"

Fixed in 55f3893.

mattwang44 · 2026-03-15T15:46:07Z

library/asyncio-graph.po

+"或 :class:`TaskGroup`\\ 。任何時候涉及使用低階 API（如 :meth:`Future."
+"add_done_callback() <asyncio.Future.add_done_callback>`\\ ）的中介 :class:"


Suggested change

"或 :class:`TaskGroup`\\ 。任何時候涉及使用低階 API（如 :meth:`Future."

"add_done_callback() <asyncio.Future.add_done_callback>`\\ ）的中介 :class:"

"或 :class:`TaskGroup`。任何時候涉及使用低階 API（如 :meth:`Future."

"add_done_callback() <asyncio.Future.add_done_callback>`）的中介 :class:"

Fixed in 55f3893.

mattwang44 · 2026-03-15T15:48:02Z

library/asyncio-graph.po

 "This function prints entries starting from the top frame and going down "
 "towards the invocation point."
-msgstr ""
+msgstr "此函式會從頂層框架開始印出條目，然後往下到呼叫點。"


ditto
這個 "frame" 出現比較早，原文附註應該在這邊

Fixed in 55f3893: added （frame） annotation at first occurrence (line 49) and removed it from the later occurrence.

mattwang44 · 2026-04-07T13:46:20Z

@copilot fix the PR based on the review comments

Agent-Logs-Url: https://github.com/python/python-docs-zh-tw/sessions/d457961b-6fd9-4f61-bb43-c2454d18e40c Co-authored-by: mattwang44 <24987826+mattwang44@users.noreply.github.com>

Copilot · 2026-04-07T13:59:04Z

@copilot fix the PR based on the review comments

All review feedback addressed in 55f3893:

Added missing "Call" in "Call Graph Introspection"
Kept "runtime" untranslated
Fixed asterisk/backslash formatting around *任務* and *future*
Fixed 除錯器 → 偵錯器
Moved （frame） annotation to first occurrence, removed it from later occurrence
Changed 當前 → 目前 throughout
Removed extra backslashes in multiple translation strings

josix added 2 commits February 4, 2026 20:37

feat: translate library/asyncio-graph.po

40ba09c

Complete translation of asyncio Call Graph Introspection documentation covering print_call_graph(), format_call_graph(), capture_call_graph() and low-level utility functions.

Merge branch '3.14' into library/asyncio-graph

5fa41ed

mattwang44 reviewed Mar 14, 2026

View reviewed changes

python deleted a comment from wilson-wang-appier Mar 14, 2026

josix requested a review from mattwang44 March 14, 2026 05:32

mattwang44 reviewed Mar 15, 2026

View reviewed changes

Copilot started work on behalf of mattwang44 April 7, 2026 13:46 View session

fix: address review feedback on asyncio-graph.po translation

55f3893

Agent-Logs-Url: https://github.com/python/python-docs-zh-tw/sessions/d457961b-6fd9-4f61-bb43-c2454d18e40c Co-authored-by: mattwang44 <24987826+mattwang44@users.noreply.github.com>

Copilot finished work on behalf of mattwang44 April 7, 2026 14:01

Copilot AI requested a review from mattwang44 April 7, 2026 14:01

	msgstr "呼叫圖內省（Graph Introspection）"
	msgstr "呼叫圖內省（Call Graph Introspection）"

	"任務\\ ，或是暫停的\\ future\\ 的完整呼叫圖。這些工具和底層機制可以在 "
	"任務，或是暫停的 future 的完整呼叫圖。這些工具和底層機制可以在 "

	"asyncio 擁有強大的執行期呼叫圖內省工具，可以追蹤執行中的\\ 協程\\ 或\\ "
	"asyncio 擁有強大的 runtime 呼叫圖內省工具，可以追蹤執行中的\\ 協程\\ 或\\ "

	"Python 程式內部使用，或被外部分析器和除錯器使用。"
	"Python 程式內部使用，或被外部分析器和偵錯器使用。"

	"如果在\\ 當前任務\\ 上呼叫此函式，可以使用選擇性的僅限關鍵字引數 depth "
	"如果在\\ 目前任務\\ 上呼叫此函式，可以使用選擇性的僅限關鍵字引數 depth "

		"類似於 :func:`print_call_graph`\\ ，但回傳一個字串。如果 future 為 "
		"``None`` 且沒有當前任務，此函式回傳一個空字串。"

	"捕獲當前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"
	"捕獲目前任務或所提供的 :class:`Task` 或 :class:`Future` 的非同步呼叫圖。"

		"此函式接受一個選擇性的 future 引數。如果未傳入，將使用當前執行中的任務。"
		"如果沒有當前任務，此函式回傳 ``None``\\ 。"

		"或 :class:`TaskGroup`\\ 。任何時候涉及使用低階 API（如 :meth:`Future."
		"add_done_callback() <asyncio.Future.add_done_callback>`\\ ）的中介 :class:"

Uh oh!

Conversation

josix commented Feb 4, 2026

Uh oh!

github-actions bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Built to branch gh-pages at 2026-02-04 12:48 UTC. Preview will be ready when the GitHub Pages deployment is complete.

Uh oh!

josix commented Feb 4, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

josix commented Mar 14, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

mattwang44 commented Apr 7, 2026

Uh oh!

Copilot AI commented Apr 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions bot commented Feb 4, 2026 •

edited

Loading

Built to branch `gh-pages` at 2026-02-04 12:48 UTC.
Preview will be ready when the GitHub Pages deployment is complete.